Modulscripte im Kernmodul

Seit Version 2.1 werden die Datenbankschemata und Scripte der Module in einem einheitlichen Format zusammengestellt und in einer Datei $SUPERX_DIR/db/module/$MODULNAME/conf/$MODULNAME.xml gespeichert. Das XML-Format hat den Vorteil, dass die Scripte dynamisch für Postgres und Informix erzeugt werden können, und dass die Scripte vereinheitlicht werden. Aus dieser Datei werden die Scripte erzeugt, die das Modul jeweils für Postgres und Informix installieren / updaten /aktualisieren / überprüfen und entfernen. Die folgende Abbildung zeigt das Vorgehen:

 

Aus der xml-Datei werden die jeweiligen Scripte für die Installation, den Update, die Extraktions-, Transformations- und Ladescripte (ETL) und die Deinstallation erzeugt.

 

Die Modul-Scripte liegen als Shellscripte im Verzeichnis $SUPERX_DIR/db/bin, und sind an anderer Stelle im Detail erläutert.

 

module_install.x <<name>> <<pfad>>

Installiert ein Modul, d.h. erzeugt die Tabellen, Views, Funktionen und Abfragen. Die Abfragen werden in den Themenbaum eingehängt.

module_etl.x <<name>> <<pfad>>

Aktualisiert das Modul, d.h. lädt die Rohdaten, Transformiert sie, und aggregiert die Hilfstabellen. Fehler werden in eine Log-Datei geschrieben, diese kann dann per Mail an einen Admin versandt werden. Wenn das Script erfolgreich durchläuft, wird die Tabelle systeminfo aktualisiert.
Das Script wird nicht direkt als Cronjob aufgerufen, sondern von einem Shellscript, das die Umgebungsvariablen und Parameter setzt, z.B. cob_update.x.

module_drop.x <<name>> <<pfad>>

Entfernt das Modul bzw. die Tabellen, Views, Funktionen und Abfragen.

module_update.x <<name>> <<pfad>>

Ein Modulupdate wird durchgeführt, d.h. eine neue Version des Moduls wird installiert (nicht zu verwechseln mit dem regelmäßigen Update im Sinne eines ETL-Prozesses).

module_scripts_create.x
<<name>>
<<pfad>>
 <<Datenbanksystem(optional, INFORMIX, POSTGRES)>>
<<Versionsnr.>>

Erzeugt via XSL-Transformation die jeweiligen Scripte, die in den obigen Scripten aufgerufen werden, z.B. bau_install_ids.sql für das Installationsscript des Baumoduls beim Informix Dynamic Server.

 

Neben den operativen Scripten erzeugt module_scripts_create.x auch html-Dateien zur Dokumentation eines Moduls in
$SUPERX_DIR/db/module/<<Modulname>>/conf/<<Modulname>>.html
(auch als rtf-Datei zu Einbindung in Modul-Dokumentationen)  sowie zur Schnittstelle in
$SUPERX_DIR/db/module/<<Modulname>>/rohdaten/<<Modulname>>_unload.html

Darüber hinaus werden auch DBForms-Formulare erzeugt.


Zur Superx-Homepage SuperX ist auch ein CampusSource-Projekt. Zur CampusSource-Homepage | Powered by FreeMarker Seite 189 / 257
Letzter Update: 07.06.2007
Impressum